<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
  <head>
    <meta name="author" content="Paul Bender" />
    <meta name="copyright" content="2006-2008 Paul Bender &amp; minimyth.org" />
    <meta name="keywords" content="Minimyth2,Linux,PVR,Linux,MythTV,diskless,Mini-ITX,EPIA" />
    <meta name="description" content="" />
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>Minimyth2 - Documents - Use Instructions</title>
    <style type="text/css" title="main-styles">
      @import "css/minimyth.css";
    </style>
  </head>
  <body>
    <div class="main">
      <div class="header">
        <div class="heading">MiniMyth2</div>
        <div class="menu">
          <span class="menuItemFirst"><a href="index.html">Home</a></span>
          <span class="menuItem"     ><a href="document.html">Documents</a></span>
          <span class="menuItem"     >Use</span>
        </div>
      </div>
      <div class="middle">
        <div class="heading">Use Instructions</div>
        <div id="toc" class="section">
          <div class="heading">Table of contents</div>
          <dl>
            <dt><a href="#general">General</a></dt>
            <dt><a href="#control">Control</a></dt>
            <dt><a href="#control-remote">Control using a Remote Control</a></dt>
            <dt><a href="#control-vnc">Control using VNC</a></dt>
            <dt><a href="#access">Access</a></dt>
            <dt><a href="#access-console">Access using a Virtual Console</a></dt>
            <dt><a href="#access-telnet">Access using Telnet</a></dt>
            <dt><a href="#access-ssh">Access using SSH</a></dt>
            <dt><a href="#access-http">Access using HTTP</a></dt>
          </dl>
        </div>
        <div id="general" class="section">
          <div class="heading">General</div>
          <p>
          </p>
        </div>
        <div id="control" class="section">
          <div class="heading">Control</div>
          <p>
          </p>
        </div>
        <div id="control-remote" class="section">
          <div class="heading">Control using a Remote Control</div>
          <p>
            The normal method for controlling MiniMyth2 is through a remote control.
            If you have not already done so, please the
            <a href="document-minimyth_conf.html#MM_LIRC">LIRC configuration variables' section of minimyth.conf</a>
            for instructions on how to configure your specific remote.
          </p>
        </div>
        <div id="control-vnc" class="section">
          <div class="heading">Control using VNC</div>
          <p>
            For some of the entries in the Myth setup menus, it is easier to use a keyboard than a remote control.
            While MiniMyth2 supports connecting a keyboard and mouse, it is often physically difficult to do so.
            Therefore, MiniMyth2 support controlling the MiniMyth GUI using VNC.
          </p>
          <p>
            In general, VNC enables a client to connect to either the real X display or a virtual X display.
            By connecting to the real X display, a VNC client can control the X session running on the remote machine's console.
            By connecting to a virtual X display, a VNC client can have its own X session.
            Since MiniMyth2 uses VNC as a method for remotely controlling the frontend,
            MiniMyth2 uses a VNC server that connects the VNC client to the real X display.
          </p>
          <p>
            When security is enabled
            (see '<a href="document-minimyth_conf.html#MM_SECURITY_ENABLED">MM_SECURITY_ENABLED</a>'),
            then VNC is available on localhost but not on any other address.
            Therefore, when security is enabled, VNC can only be accessed by port forwarding over SSH.
          </p>
        </div>
        <div id="access" class="section">
          <div class="heading">Access</div>
          <p>
          </p>
        </div>
        <div id="access-console" class="section">
          <div class="heading">Access using a Virtual Console</div>
          <p>
            Normally, MiniMyth2 does not start a virtual console.
            However, when MiniMyth2 detects an error when booting (i.e. during init),
            MiniMyth2 starts a virtual console to ease debugging.
            In addition, when security is disabled
            (see '<a href="document-minimyth_conf.html#MM_SECURITY_ENABLED">MM_SECURITY_ENABLED</a>'),
            MiniMyth2 starts a virtual console.
            If you have a keyboard connected,
            then you can switch to the virtual console using the key sequence 'Ctrl+Alt+F1'.
          </p>
          <p>
            There are two users that can connect using the virtual console: 'minimyth' and 'root'.
            Neither user requires a password.
          </p>
          <p>
            The user 'minimyth' is a restricted access user that MiniMyth2 uses
            to run the X window system (i.e. xinit) and X applications (e.g. mythfrontend, mythtv, mplayer, x11vnc and xine).
            Since many applications look for their configuration relative to the user's home directory, and
            since some applications behave differently depending on user's access rights,
            it is important that you run the X windows system and the X applications as the correct user.
          </p>
          <p>
            The user 'root' is the root user.
            You may wish to log in as the user 'root' when you need access beyond the access allowed the user 'minimyth'.
            For example, some files can only be written or read as the user 'root'.
          </p>
        </div>
        <div id="access-telnet" class="section">
          <div class="heading">Access using Telnet</div>
          <p>
            Normally, MiniMyth2 does not start a telnet server.
            However, when MiniMyth2 detects an error when booting (i.e. during init),
            MiniMyth2 starts a telnet server to ease debugging.
            In addition, when security is disabled
            (see '<a href="document-minimyth_conf.html#MM_SECURITY_ENABLED">MM_SECURITY_ENABLED</a>'),
            MiniMyth2 starts a telent server.
          </p>
          <p>
            There are two users that can connect using telnet: 'minimyth' and 'root'.
            Neither user requires a password.
          </p>
        </div>
        <div id="access-ssh" class="section">
          <div class="heading">Access using SSH</div>
          <p>
            If you have enabled the
            <a href="document-minimyth_conf.html#MM_SSH_SERVER">SSH server</a>,
            then MiniMyth2 provides access using ssh.
            During normal operation, there is no reason to need ssh access to MiniMyth2.
            However, ssh access can be very useful when customizing or debugging MiniMyth2.
          </p>
          <p>
            There is one user that can connect using ssh: 'root'.
            When connecting as user 'root',
            you must present a identity file authorized in the
            <a href="document-configure.html#authorized_keys">authorized_keys</a>
            configuration file.
          </p>
          <p>
            If you need to perform a task as the user 'minimyth' (e.g. restart X),
            then you will need to su to the user 'minimyth' using the command
            'su&nbsp;-&nbsp;minimyth'.
          </p>
        </div>
        <div id="access-http" class="section">
          <div class="heading">Access using HTTP</div>
          <p>
            MiniMyth2 provides access to the MiniMyth web pages using HTTP.
            The MiniMyth2 web pages are accessable by connecting to port 80 (the default HTTP port) using HTTP.
            These web pages include status infomation, software version information and MiniMyth2 documentation.
            Unlike the MiniMyth2 documentation on
            <a href="http://minimyth.org">minimyth.org</a>,
            the MiniMyth2 documentation available through the MiniMyth web pages is sure to correspond to the version of MiniMyth that is running.
          </p>
          <p>
            When security is disabled
            (see '<a href="document-minimyth_conf.html#MM_SECURITY_ENABLED">MM_SECURITY_ENABLED</a>'),
            MiniMyth2 provides access to the MiniMyth file system using HTTP.
            The MiniMyth2 file system is accessable by connecting to port 8080 using HTTP.
            This allows you to view any file using a web browswer (e.g. Firefox)or download any file using a web download client (e.g. wget).
          </p>
        </div>
      </div>
      <div class="footer">
        <hr />
        <div class="valid-xhtml">
          <a href="http://validator.w3.org/check?uri=referer"><img
              src="/image/w3c-valid-xhtml11-blue.gif"
              alt="Valid XHTML 1.1" height="31" width="88" /></a>
        </div>
        <div class="valid-css">
          <a href="http://jigsaw.w3.org/css-validator/check/referer"><img
              src="/image/w3c-valid-css2-blue.gif"
              alt="Valid CSS!"      height="31" width="88" /></a>
        </div>
        <div class="version">
          Last Updated on 2017-08-10
          <br />
          &lt;&nbsp;mailto&nbsp;:&nbsp;warpme&nbsp;at&nbsp;o2&nbsp;dot&nbsp;pl&nbsp;&gt;
        </div>
      </div>
    </div>
  </body>
</html>
